<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><title>Firefox Extension</title>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
<meta http-equiv="Content-Style-Type" content="text/css">
</head>
<body>

<img alt="Firefox Extension" src="img/lockcrypt-firefox.png" class="centered"/>
<p>LockCrypt's Firefox extension can automatically save forms to LockCrypt accounts, then fill forms automatically the next time you visit a page.</p>
<p>The extension can be downloaded from <A href="https://addons.mozilla.org/en-US/firefox/addon/8970" target=_blank>addons.mozilla.org</A>.</p>

<div class="contents">
<h4>Contents</h4>
<ol>
  <li><A href="#using">Using the Extension</a></li>
  <li><A href="#autocreate">Creating Accounts Automatically</a></li>
  <ol>
    <li><A href="#savingopts">Options when Saving</a></li>
  </ol>
  <li><A href="#manualcreate">Manually Creating Accounts</a></li>
  <li><A href="#prefs">Preferences</a></li>
  <li><A href="#impexp">Importing/Exporting between LockCrypt and Firefox</a></li>
  <li><A href="#filling">Filling Forms</a></li>
  <li><A href="WildcardURLs.htm">Wildcard URLs</A></li>
</ol>
</div>

<h2><a name="using">Using the Extension</a></h2>
<p>For the LockCrypt Firefox extension to work, LockCrypt must be running and you must be logged in. Icons will be placed in the toolbar and a status bar which can be used to fill forms and change options. Clicking the main toolbar button will fill forms on the current page (as long as LockCrypt is running). </p>
<img alt="LockCrypt toolbar icon" src="img/ss_ff_toolbar.png" class="centered"/>

<h2><a name="autocreate">Creating Accounts Automatically</a></h2>
<p>When you load a page for the first time, LockCrypt will automatically prompt you to save the username and password when the submit button is clicked if an identical account has not already been saved. If you choose to create a new account from the data on the page, LockCrypt will save this so it can be used the next time you visit that page.</p>
<p>When you visit a page for which you've previously saved an account, if you have autofill enabled, LockCrypt will fill each form on the page with the first available matching account.</p>
<p>If there is more than one account saved for a particular form, the Fill Forms function can be used (<em>Tools-&gt;Fill Forms from LockCrypt</em>). This works the same way as autofill if there is only one form saved for the page, otherwise LockCrypt will prompt for the account to use.</p>
<P>Creating accounts automatically is a fairly safe way of guaranteeing a match 
against a form, as the field names on the form will be matched to the field 
names saved when the account was created.</P>

<h3><a name="savingopts">Options when Saving</a></h3>
<p>When an account is created, by default all fields which were filled in are saved and the account only applies to the specific page for which it was created. By unchecking Valid for this URL Only, the account will be available for all web sites.</p>
<img alt="Options when saving" src="img/ss_firefox_save.png" class="centered"/>
<p>It is also possible to change which fields are saved. By clicking Options on the save dialog, fields can be toggled on/off or renamed. </p>

<h2><a name="manualcreate">Manually Creating Accounts</a></h2>
<p>For more control, accounts can also be created manually. When you use a manually created account to fill forms, LockCrypt will analyze all forms on the current page and attempt to fill applicable fields.</p>
<P>The <em>Username Field</em> and <em>Password Field</em>&nbsp;fields are used to decide whether a form field matches a field stored in an account.</P>
<P><strong>Note:</strong> Only form fields whose <em>name</em> attribute exactly matches the saved field will be classified as a match when filling. Field names are case sensitive.</P>
<p>To check whether an account matches, URLs in Website templates are matched against the current URL. To have an account match all URLs, leave the URL field blank when creating the account.</p>
<p>Occasionally, LockCrypt may not attach itself to a form and fail to prompt to create an account when submitting. If this happens, the form can be manually saved by clicking either the toolbar icon or status icon, then <em>Save Forms</em>, then selecting the form by name. </p>

<h2><a name="prefs">Preferences</a></h2>
<p><strong>Enabled</strong> - If LockCrypt is enabled, you'll be prompted to save form details when you submit a form, unless one's already been saved. If disabled, LockCrypt will appear transparent and all functionality will be disabled.</p>
<p><strong>Timeout when saving</strong> - The amount of time to wait for a reply from LockCrypt when saving a form, before assuming it's not running and prompting to submit anyway.</p>
<p><strong>Autofill</strong> - Autofill will automatically try to fill forms when you load a page if an account exists matching the page URL. If Autofill is disabled, you can still fill forms manually using Tools-&gt;Fill Forms from LockCrypt.</p>
<p><strong>Exclude List</strong> - To have LockCrypt ignore a specific site, click the toolbar icon, then Exclude Current Site or add it to the exclude list in the extension options. If a site is excluded, autofill will ignore it and you will not be prompted to save, but you can still fill forms by clicking the toolbar icon.</p>

<h2><a name="impexp">Importing/Exporting between LockCrypt and Firefox</a></h2>
<p>The options dialog lets you transfer passwords between Firefox and LockCrypt. If you use LockCrypt with a MySQL database, this lets you keep a central password database. </p>

<h2><a name="filling">Filling Forms</a></h2>
<p>If autofill is enabled, the first matching account will be used to fill matching textboxes on the page. Otherwise, click <em>Tools-&gt;Fill Forms from LockCrypt</em> to select an account to fill from. </p>

</body></html>